home *** CD-ROM | disk | FTP | other *** search
/ Ultra Pack / UltraComputing Technology Demos and Tools.iso / xil / xildemotips.txt
Encoding:
Text File  |  1996-03-29  |  7.8 KB  |  294 lines
  1.  
  2. XIL Demo's: User Guide
  3. ----------------------
  4.  
  5. Contents:  
  6.  
  7. 1). PixelBlaster Quick Tips
  8.     To Get Started
  9.     Features and Functions
  10.     Saving your work
  11.  
  12.  
  13. 2). XIL Scale Demo Quick Tips
  14.     To Get Started
  15.     Global application tips
  16.  
  17. ======================================================================
  18.  
  19. 1). Pixel Blaster -- how to use:
  20.  
  21. This general purpose image manipulation application uses a 
  22. simple drag and drop interface in combination with the Solaris
  23. file manager. By applying any one of several geometric operations 
  24. to the working image, you can experiment with the dynamics of
  25. real time, interactive 2d imaging performance.
  26.  
  27.  
  28. To get started:
  29.  
  30. (Note: Assuming that you have Volume Management running, you 
  31. will see two file manager windows pop onto the screen. One is
  32. for the CDROM and the other is for the image library. You can
  33. close the CDROM file manager window as you won't be needing it
  34. for this demo)
  35.  
  36. From the image library file manager window, click on the icon
  37. of an image you're interested in and drag it to the drop target
  38. zone in the PixelBlaster window (small grey square in the window
  39. labeled "SX/XIL" demo). The image should automatically load from
  40. the CDROM and display in the window. You can resize the image
  41. window to suit your needs.
  42.  
  43. Once the image has been successfully loaded, click on the "Controls"
  44. button. This brings up a new window which gives you a palette of
  45. geometric options you can apply to the source image (the first 
  46. operation by default is "Rotate"). By pressing and holding the right
  47. mouse button, you should get a sub-menu with five more functions.
  48.  
  49.  
  50. Features and Functions
  51.  
  52.  
  53. All six operations are described below:
  54.  
  55.  
  56.     Rotate: (uses XilRotate())
  57.  
  58.     With the mouse pointer in the main image canvas,
  59.     click and drag with any mouse button. The image should
  60.     immediately begin rotating in conjunction with the mouse 
  61.     movement.
  62.  
  63.  
  64.  
  65.     Flip: (uses XilFlip())
  66.  
  67.     A generalization of the rotate function. The "flip"
  68.     function flips the image in the main canvas by 90 degrees.
  69.     With the mouse pointer in the main image canvas, click and
  70.     drag with any mouse button. The image should flip in
  71.     very rapid succession.
  72.  
  73.  
  74.  
  75.     Zoom: (uses XilScale())
  76.  
  77.     With the mouse pointer in the main image canvas, press and
  78.     hold any mouse button. As you move the mouse pointer
  79.     in the Cartesian X or Y direction, the image should scale
  80.     (nearest neighbor algorithm) in X,Y or some combination thereof.
  81.  
  82.  
  83.     
  84.     Pan:  (uses XilTranslate())
  85.  
  86.     With the mouse pointer in the main image canvas, press and
  87.     hold any mouse button. By moving about the mouse pad in any
  88.     given combination of X and Y, you can navigate around the 
  89.     image.
  90.  
  91.  
  92.  
  93.     Affine: (uses XilAffine())
  94.  
  95.  
  96.     This operation warps the image depending on how you move the
  97.     mouse pointer around the main image canvas. With the mouse
  98.     pointer in the main image canvas, press and hold any mouse
  99.     button. By moving the pointer around, you can quickly get a 
  100.     feel for the speed and quality of applying this complex operation
  101.     on all pixels in the image.
  102.  
  103.  
  104.  
  105.     Stretch: 
  106.     
  107.     With the mouse pointer in the main image canvas, press and 
  108.     hold any mouse button. By moving the mouse pointer in either
  109.     the X or Y direction, you can stretch or squash the source
  110.     image interactively. 
  111.  
  112.  
  113.  
  114.     Update:
  115.  
  116.  
  117.     Applies the current coefficients of the given operation to the
  118.     image permanently, allowing you to apply cumulative changes to
  119.     the image you are working with.
  120.  
  121.  
  122.  
  123. Saving your work:
  124.  
  125.     To save your image, use the "snapshot" deskset tool to grab a 
  126.     copy of the entire window or just a region of the image you are
  127.     interested in. The "snapshot" application is part of the default
  128.     toolset supplied with both OpenWindows and CDE.
  129.  
  130.  
  131. ======================================================================
  132.  
  133.  
  134. 2). XIL Scale Demo
  135.  
  136.  
  137. This demo focuses specifically on the various controls and features
  138. of the XIL Scale operation. Since fast, interactive image scaling is
  139. gaining significant performance in several areas of high performance
  140. imaging applications, it is worth exploring the features of this one
  141. function in greater detail.
  142.  
  143.  
  144. To Get Started:
  145.  
  146. (Note: Assuming that you have Volume Management running, you 
  147. will see two file manager windows pop onto the screen. One is
  148. for the CDROM and the other is for the image library. You can
  149. close the CDROM file manager window as you won't be needing it
  150. for this demo)
  151.  
  152. From the image library file manager window, click on the icon
  153. of an image you're interested in and drag it to the drop target
  154. zone in the "Xil Scale Demo" window (small grey square in the right hand
  155. corner of the window labeled "Xil Scale Demo"). The image should 
  156. automatically load from the CDROM and display in the window. 
  157. You can resize the image window to suit your needs.
  158.  
  159.  
  160.  
  161.  
  162. Global application tips: 
  163.  
  164.  
  165. Statistics:
  166.  
  167. The current image statistics (width, height, size) are always
  168. displayed in the lower left hand corner of the main image canvas. 
  169. In the upper left hand corner are the speed of image copy to the
  170. main canvas in MegaPixels per second, and the number of frames per
  171. second copied to the screen. 
  172.  
  173.  
  174. Mouse button behavior (in "Manual" mode)
  175.  
  176. When "Manual" mode is selected, the left and right mouse buttons act
  177. as a panning function when pressed and held while moving the mouse
  178. pointer in the main image canvas. The middle mouse button applies the
  179. Interpolation method as selected in the "Interpolation" indicator menu.
  180.  
  181.  
  182.  
  183. Features and Functions
  184.  
  185.  
  186. The following functions are available:
  187.  
  188.  
  189. About:
  190.  
  191. Tells you (briefly) about the demo
  192.  
  193.  
  194.  
  195. Reset View:
  196.  
  197. Takes you back to the default orientation of the original image.
  198.  
  199.  
  200.  
  201. Refresh:
  202.  
  203. Clears any screen tears or stray pixels in the image window.
  204.  
  205.  
  206.  
  207. Controls (Expert Controls)
  208.  
  209.  
  210.     X and Y (%) Scaling: 
  211.  
  212.     Allows you to set the total % of change in both X&Y directions using the
  213.     slider for more precise control.
  214.  
  215.  
  216.  
  217.     Y Only (%) Scaling:
  218.  
  219.     Same as above, except that you can only scale in the "Y" direction.
  220.  
  221.  
  222.  
  223.     DataType:
  224.  
  225.     Only use Short or 4 Bands with your own images of these types. All
  226.     images provided with the XilScale demo are 3 banded byte images.
  227.     (e.g. 3 bands:  Red, Green, Blue where each band is 8 bits deep).
  228.  
  229.  
  230.  
  231.     Redisplay Once:
  232.  
  233.     Use this to simply re-draw the image once.
  234.  
  235.  
  236.  
  237.     Redisplay "n" times:
  238.  
  239.     Using the value in the "Times To Redisplay", this function copies
  240.     the image on the screen to the display the number of times specified.
  241.  
  242.  
  243.     Source Origin:
  244.  
  245.     Use these sliders to explicitly set the source origin from which to 
  246.     scale.
  247.  
  248.  
  249.     Destination Origin:
  250.  
  251.     Use these sliders to explicitly specify the destination origin to scale
  252.     to.
  253.  
  254.  
  255.     Destination Size:
  256.  
  257.     Use these sliders to set the destination size (in pixels) of the final
  258.     image to scale to.
  259.  
  260.  
  261.  
  262.  
  263. Interpolation Method:
  264.  
  265.     Nearest: Lowest quality, ultrafast performance. This method merely uses
  266.     neighboring pixels to replicate the image data when scaling. Results
  267.     in extremely blocky or pixelated images when zoomed at large values.
  268.  
  269.     Bilinear: Higher quality, very fast performance. This method applies
  270.     a special smoothing function in addition to scaling the target image
  271.     data to provide much higher quality. The bilinear interpolation method
  272.     is much more computationally complex than nearest neighbor
  273.     interpolation.
  274.  
  275.     Bicubic: Highest quality, fast performance. This method applies
  276.     a high quality smoothing function in addition to scaling the target 
  277.  
  278.     image data to provide the highest quality. The bicubic interpolation
  279.     method is more computationally complex than both the nearest neighbor
  280.     and bilinear interpolation methods.
  281.  
  282.  
  283. Mode:
  284.  
  285.     Manual: Allows you to apply the given interpolation method interactively
  286.     by using the left or right mouse button for panning within the main 
  287.     image canvas and the middle mouse button for applying the scaling
  288.     function.
  289.  
  290.     Automatic: Using a simple randomizing algorithm, the application moves
  291.     about the main image canvas iteratively scaling the image using the 
  292.     scaling algorithm selected in "Interpolation".
  293.  
  294.